The PC-SIG Library 10

home *** CD-ROM | disk | FTP | other *** search

/ The PC-SIG Library 10 / The PC-Sig Library - Shareware for the IBM PC and Compatibles (PC-SIG)(Tenth Edition Disks 1-2804)(1991).iso / PC_SIGCD / 03 / 7 / DISK0378.ZIP / FSED.DOC < prev next >

Wrap

Text File | 1985-01-05 | 17KB | 429 lines

FSED A Full Screen Editor for The IBM Personal Computer Version 2.0 Copyright 1983 by D. W. Daetwyler 1 Full Screen Editor - Version 2.0 TABLE OF CONTENTS Page PREFACE 3 INTRODUCTION 4 STARTING OUT 5 EDITING A FILE 9 COMMANDS 12 SCROLLING 13 CURSOR MOVEMENT 14 CHARACTER MANIPULATION 16 LINE MANIPULATION 17 SEARCH 19 FILE CONTROL 20 EDITOR CONTROL 22 MISCELLANEOUS 24 CONCLUSION 26 ERROR MESSAGES 27 APPENDIX A 29 APPENDIX B 30 APPENDIX C 32 APPENDIX D 33 QUICK REFERENCE 34 Table of contents 2 Full Screen Editor - Version 2.0 EPREFACEF This is a T.P.I.R product! (The Price Is... Reasonable?) I object to paying half the price of my hardware for a single software package, so I'm trying to do something about it. I believe that there are enough "micros" around to make a reason- able return on your labor investment through volume... if you don't have to pay substantive advertising and marketing costs. If you're reading this document, you have the package. It is copyrighted, so what are your rights? They are given here: -- You are free to copy, and encouraged to distribute to any/all of your friends, the materials included in the distribution diskettte. Please include this document. -- You may use these materials in any way you see fit, but you may not "sell" the package. Where's the "catch"? Simple. Its up to you. If you use this package, and like it, send me a check for $35. Otherwise, thanks for experimenting! What do you get for the $35, besides a clear conscience? Not much. I'll put you on my mailing list and when (not if) bugs are encountered, I'll notify you and offer our handy, dandy copy service, which incidentally is available to all your friends for their initial copy, if you don't want to bother copying the diskette. I'll also notify you when future develop- ments are available: we now have the Screen Design Aid, a util- ity that takes a lot of the drudgery out of building interactive menus; the LIST utility, which allows for "wild card" print requests, optionally provides headings, and fully supports all of the many and varied modes of printing without messing with the MODE command; and a Full Screen Editor, primarily for programming, which supports either display interface, provides very "full function", and is FAST. All operate on PC-DOS V1.x or V2.0. The copy service mentioned is also simple: Send diskette, mailer, and enough postage to the writer and we'll make a copy of the distribution diskette for you. If you don't want to send the diskette, mailer, et al., send a check for $7.50 and we'll send you a new diskette with the materials (Single surface, 8 sector). The last page of this document is an order/registration form. DISCLAIMER (Or I really don't want to be sued!) Although reasonable testing has been conducted, under no circumstances will the author be liable to you or any third party for any damages, including lost profits or other incidental or consequential damages arising out of the use of, or the inability to use, this software. Further the offers made in this document are subject to withdrawal at any time and without notification, and prices quoted are subject to change without notice. Preface 3 Full Screen Editor - Version 2.0 INTRODUCTION The Full Screen Editor (FSED) is primarily a programming development tool for the applications or systems programmer. It is designed to work with the IBM Personal Computer, using either the Monochrome Display or the Color/Graphics interface, and at least one disk. Although the editor will operate on machines with as little as 64K bytes of memory, its design point for optimum operation is the 128K memory system. As an environment, it expects the IBM Disk Operating System (DOS) Versions 1.x or 2.0, and uses the facilities of this operating system as well as the facilities of the Basic Input/Output System (BIOS). Although programming language independent, the editor will be of most use to the programmer using Assembler, PASCAL, or FORTRAN. The BASIC programmer's use of the editor will probably be limited to selected special functions (eg: search for a vari- able name), and no specific format processor for BASIC is in- cluded in the editor. Users of the BASIC Compiler will find the editor useful, however. Similarily, although selected functions permit the use of the editor for "text" processing, these tools are limited and primitive when compared to a normal, full func- tion, text processor. The editor works with "files" which are normal DOS files in ASCII or source form. Files to be processed by this editor are limited to "lines" of not greater than 80 characters. * * * WARNING * * * If editing is attempted on files containing lines of more than 80 characters, truncation will occur and portions of the data will be lost. Under certain conditions, attempting to apply functions against these lines may cause catastrophic error!!! Using the facilities of the editor, the programmer may: create or modify source language files, extract portions of existing files, insert existing files into other files, or use existing files to create new files. Twenty-four lines of source are normally displayed during all editing functions, and pro- vision is made for "paging" through files by displaying sucessive pages. Characters can be changed, deleted, or inserted into existing lines. New lines may be added, existing lines deleted, moved, or copied. Finally, a substantial number of "control" functions can be exercised, most by the depression of a single key. All of the functions, with the exception of those that are limited by disk speeds, are performed at speeds essentially within the human response range. Introduction - 4 Full Screen Editor - Version 2.0 STARTING OUT Since the Full Screen Editor requires IBM DOS to operate, it is assumed that you are familiar with the terms and conventions of the DOS. File names and disk operations are those supported by the standard DOS, so no attempt is made to cover this material in this document. In an attempt to keep this document simple, many details of functioning are omitted from the main discussion. These details are generally not important to the typical user, however since they may effect some unique process you are attempting they are included in the set of appendicies appearing at the back of this document. When the general area effected by the appendix is first discussed a parenthetical reference is included (eg: Appen- dix A). You should read through the material as it is presented, omitting the appendicies during your first use of the editor. As your familiarity grows and you attempt more complex use, then reference to the appendicies will resolve most questions that may arise. This document is written for the "new" programmer. For the experienced programmer, scanning this introductory material should be sufficient. The largest section of this document, "COMMANDS", should be reviewed by all users, and will provide a ready reference during productive use of the editor. SAVING THE EDITOR The distribution diskette included with this manual contains a file named FSED.COM. Your first action should be to copy this file to a work diskette containing your IBM DOS. Use the Copy utility included with your DOS, following the instructions pro- vided in the DOS manual. File and save your distribution disk- ette as your "master". The distribution diskette is "file pro- tected" which will prevent accidental destruction of your "master". USING THE EDITOR The editor will operate properly on either one or two drive systems. Initially, we'll use it by inserting the work diskette containing IBM DOS and the FSED.COM file in the drive "A". To start the editor you may use any of three forms of DOS commands: A:>FSED A:>FSED yourfile.type A:>FSED yourfile.type outfile.type As you gain familiarity with the editor, the second form shown above is the one you'll use most frequently. To help you get started, we'll discuss all three forms and the editor's response to each. Starting Out - 5 Full Screen Editor - Version 2.0 In all three cases, when you enter this command, the screen will briefly display an identification screen that simply announ- ces the editor has been loaded properly. If you have used the first form of the command, a prompt near the bottom of the screen will ask for your file name. Just as in the second and third forms of the command, the file name requested is a "fully quali- fied" DOS file name. Drive may be specified, and if it is not then the "default" or signed on drive is implied. "type" is not required by the editor, but most language processors do require it, so normally it should be specified. If the file you have named exists on the drive you have specified or defaulted to, then the first 24 source lines of the file will be displayed without further action. If the directory does not contain the name you gave, then a prompt will appear at the bottom of the screen: "New file - (Y or N)" If you are actually creating a new file, reply "Y" and you will be presented with a "blank" screen containing only the editor prompt line (line 25), and an "end of file" marker line. If you have made an error in specification of your file name, reply "N", and the editor will prompt for the correct name, just as it did when the first form of the command was used to initiate the editor. Before discussing the third form of the command, it is necessary to understand how the editor handles file names and directory updates. The editor is designed to prevent catastrop- hic data loss. If you are updating an existing file, that file in its original form, will still exist at the conclusion of the edit process. Editing the file actually causes the creation of a new file containing the edit changes, and normally named the same as the file specified as "yourfile" in the command or prompt sequences. The original file is renamed to "yourfile.BAK". If "yourfile.BAK" existed prior to the start of the editor, the old backup file will be automatically deleted. This complicated sounding process simply results in maintenance of two versions of "yourfile". The current version and one back up version without the last set of changes. For the editor to function properly, then, there must always be sufficient disk space available on the output drive, to con- tain the entire file being edited, plus any changes you introduce in this edit process. This is a "free space" requirement that is in addition to any "back up" files and the original file to be edited, that may already reside on the disk. The third form of the command over-rides this process. "outfile.type" is your desired name for the new file created by the editor. When this form of the command is used, the original file is not changed, and the rename to a back up file is not performed. Note that the output file need not reside on the same drive as the input file, in two drive configurations. Drive Starting Out - 6 Full Screen Editor - Version 2.0 identifier may be specified with the "outfile" name. Finally, there is one additional prompt that you will rarely see. If you have used the third form of the command and have given a name for your output file that already exists, then a prompt that warns you of this condition will appear, and you are requested to give permission to proceed ("Y") or cancel ("N"). If you permit the editor to continue, the content of the existing file will be over-written and lost!!! (Appendix A). Before proceeding into the edit process, a brief discussion of file sizes and drive configurations is appropriate. The editor is capable of processing a "very large" file, essentially limited only by the diskette capacity and the "space requirement" cited in the previous paragraphs. In actual practice, you will find it much more convienent to work with small or moderate sized files. The primary difference to the user is how "automati This disk copy was originally provided by "The Public Library", the software library of the Houston Area League of PC Users. Disks in the Public Libray are updated monthly. Check with us for the latest versions of all programs. Programs are available from the Public Library at $2 per disk on user-provided disks. To get a listing of the disks in the Public Library, send a self-addressed, stamped envelope to Nelson Ford, P.O.Box 61565, Houston, TX 77208.